FLUSH

Syntax: FLUSH [#ch]
Location: Toolkit II

The command FLUSH forces all of the QL's temporary buffers attached to the specified channel (default #3) to be emptied into that channel.  This will only work on channels attached to files {any other type of channel will return error -15 (bad parameter)}.

This command is necessary due to the use by QDOS of slave blocks whenever a file is opened.  Data can be stored partly in the slave blocks to aid speed and when writing to a file, which will only be written to that file once the channel has been CLOSEd or the slave blocks have become full.  Because of this, there is always a danger that part of the data will be lost if there is a power failure or other accident.  FLUSH helps you to avoid this.

NOTE:
FLUSH will not work with Micro Peripherals disk drives.  Nor can it be used to flush the Networks.

CROSS-REFERENCE:
See OPEN and CLOSE.
